home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / util / misc / HTML-Creator.lha / HTML-Creator / HTML-Creator.dok < prev    next >
Encoding:
Text File  |  1999-07-12  |  12.7 KB  |  387 lines
  1.  
  2.         ****************************
  3.         *                          *
  4.         *       Dokumentation      *
  5.         *            für           *
  6.         *    HTML-Creator V1.24    *
  7.         *                          *
  8.         *   © Martin Henke, 1998   *
  9.         * Alle Rechte vorbehalten. *
  10.         *                          *
  11.         ****************************
  12.  
  13.  
  14.  
  15.    Einführung
  16.    ==========
  17.  
  18. Kennen Sie das Problem? Sie wollen eine ganze Reihe Grafiken (evtl. für eine
  19. CD-ROM) übersichtlich in HTML-Seiten einbinden und haben keine Lust, das
  20. alles von Hand zu machen? Das brauchen Sie jetzt auch nicht mehr, denn jetzt
  21. gibt es `HTML-Creator'. `HTML-Creator' ist kein einzelnes Programm, sondern
  22. besteht aus 4 Programmen, die der Reihe nach aufgerufen werden. Da Sie es
  23. vermutlich kaum noch erwarten können, legen wir also gleich los.
  24. Die Programme sind so angeordnet, wie sie ausgeführt werden müssen (von oben
  25. nach unten).
  26.  
  27.  
  28. Hinweis: Ein Wort in spitzen Klammern (z.B. <RETURN>) bezieht sich auf eine
  29.      zu drückende Taste.
  30.  
  31.  
  32.  
  33.    Notwendig zur Benutzung
  34.    -----------------------
  35.  
  36. Amiga mit OS 2.0, 1 MB Speicher
  37. `Viewtek' (`VT') © Thomas Krehbiel, 1992-1994
  38.  
  39.  
  40.  
  41.    Installation
  42.    ------------
  43.  
  44. Kopieren Sie einfach das Verzeichnis `HTML-Creator' auf ein beliebiges
  45. Laufwerk.
  46.  
  47.  
  48.  
  49.    Merkmale/ Tool Types
  50.    --------------------
  51.  
  52. Über die Merkmale können Sie die Landessprache einstellen. Es werden
  53. Deutsch und Englisch unterstützt.
  54. Geben Sie als Merkmal einfach DEUTSCH bzw. ENGLISH ein.
  55. Ist kein Merkmal angegeben, bzw. ist es eingeklammert, z.B. (DEUTSCH), so
  56. wird Englisch als Standard gesetzt.
  57.  
  58.  
  59.  
  60.    Anfänger-Tip:
  61.    -------------
  62.  
  63.  Zu den Merkmalen gelangen Sie, indem Sie ein Piktogramm einmal anklicken
  64.  und dann aus dem Menü `Piktogramme' der Workbench den Punkt `Information'
  65.  auswählen. Klicken Sie im nun erscheinenden Fenster auf `Neu'. Dann geben Sie
  66.  die gewünschte Sprache (also DEUTSCH bzw. ENGLISH) ein und drücken <RETURN>.
  67.  Nun klicken Sie noch auf `Speichern' und das ausgewählte Programm gibt sämt-
  68.  liche Meldungen in Deutsch oder Englisch aus.
  69.  
  70.  
  71.  
  72. !!  Verzeichnisaufbau  !! (s. Verz.aufbau.iff)
  73.     =================
  74.  
  75. `HTML-Creator' setzt folgenden Verzeichnisaufbau als gegeben voraus:
  76.  
  77.  
  78.     [Wurzelverzeichnis]
  79.            |
  80.       Grafikverzeichnis
  81.            |
  82.       Grafikverzeichnis2----Unterverzeichnis
  83.            |
  84.       Grafikverzeichnis..n
  85.            |
  86.          ICONS--+
  87.             |
  88.           Grafikverzeichnis
  89.             |
  90.           Grafikverzeichnis2----Unterverzeichnis
  91.             |
  92.           Grafikverzeichnis..n
  93.  
  94.  
  95. - Das Wurzelverzeichnis kann ein beliebiger Pfad sein (z.B. DH1:,
  96.   WORK:, WORK:Grafik/Test,...)
  97.  
  98. - Das Grafikverzeichnis MUSS sich direkt im [Wurzelverzeichnis] befinden.
  99.   Es ist max. 1 Unterverzeichnis zugelassen.
  100.  
  101. - Es MUSS ein Verzeichnis 'ICONS' existieren. Im Verzeichnis 'ICONS' muß
  102.   sich die selbe Verzeichnisstruktur befinden, wie im [Wurzelverzeichnis],
  103.   d.h. es muß ein Verzeichnis 'Grafikverzeichnis' im Verzeichnis
  104.   'ICONS' vorhanden sein, wenn es im [Wurzelverzeichnis] vorhanden ist.
  105.   Befindet sich im Verzeichnis 'Grafikverzeichnis' ein Unterverzeichnis,
  106.   so muß dieses Unterverzeichnis auch in 'ICONS/Grafikverzeichnis' vor-
  107.   handen sein.
  108.  
  109.  
  110.  
  111. !!  Grafikformate  !!
  112.     =============
  113.  
  114. `HTML-Creator' wurde von mir geschrieben, um eine PC-kompatible CD-ROM
  115. zu erstellen. Daher werden alle Dateien im Verzeichnis 'ICONS' als
  116. GIF-Dateien (#?.GIF) angegeben (auch wenn das nicht zutrifft). Es empfiehlt
  117. sich wegen der Kompatibilität aber sowieso nur JPG, GIF und PNG als Grafik-
  118. formate zu verwenden.
  119.  
  120.  
  121.  
  122.   Bedienung
  123.   =========
  124.  
  125.  
  126. I. '   CREATE_Dir-List'
  127.    --------------------
  128.  
  129. 1. Starten Sie das Programm '   CREATE_Dir-List'.
  130.  
  131. 2. Geben Sie den Pfad ein, in dem sich die Verzeichnisse mit den Grafiken
  132.    befinden (z.B. 'Grafikdisk:Test').
  133.  
  134. 3. Geben Sie ein Verzeichnis in diesem Pfad an (z.B. 'Grafiken1'). Somit
  135.    befinden sich die Grafiken im Pfad 'Grafikdisk:Test/Grafiken1'.
  136.  
  137. 4. Wenn sich die Grafiken in einem Unterverzeichnis befinden, beantworten Sie
  138.    die Frage 'Gibt es ein Unterverzeichnis? j/n' mit <J>, ansonsten mit <N>.
  139.    Wenn Sie "J" eingegeben haben, können Sie auch das Unterverzeichnis einge-
  140.    ben (z.B. 'Subdir1'). Somit befinden sich die Grafiken im Pfad
  141.    'Grafikdisk:Test/Grafiken1/Subdir1'.
  142.    Eine weitere Verzeichnisebene wird von 'HTML-Creator' nicht unterstützt.
  143.  
  144. 5. Wenn der Name der HTML-Datei vom Verzeichnisnamen abweichen soll, beant-
  145.    worten Sie die Frage 'Soll der Name vom Verzeichnisnamen abweichen?' mit
  146.    <J>, ansonsten mit <N>.
  147.    Wenn Sie "J" eingegeben haben, können Sie den neuen Seitennamen eingeben.
  148.  
  149. 6. Wenn Sie zuletzt ein Unterverzeichnis eingegeben haben, werden Sie gefragt,
  150.    ob sich im Verzeichnis (z.B. 'Grafikdisk:Test/Grafiken1') ein weiteres
  151.    Unterverzeichnis befindet. Beantworten Sie die Frage mit "J", wenn das
  152.    der Fall ist, ansonsten mit "N".
  153.  
  154. 7. Sie werden nun gefragt, ob Sie das Programm beenden wollen. Geben Sie "J"
  155.    ein, so wird das Programm beendet; geben Sie "N" ein, so geht es weiter
  156.    mit Punkt 2.
  157.  
  158.  
  159.  
  160. Ia. Von `   CREATE_Dir-List' erzeugte Dateien
  161.     -----------------------------------------
  162.  
  163.    `   CREATE_Dir-List hat nun 4 Dateien erzeugt, nämlich `   CREATE_Lists',
  164.    `   CREATE_ListsII', `  Sort_ListsII' und `directories.txt'.
  165.  
  166.    Diese Dateien mit Ausnahme von `directories.txt' sind Batch-Dateien,
  167.    d.h. sie beinhalten Befehle, die von AmigaDOS der Reihe nach abgearbeitet
  168.    werden.
  169.  
  170. 1. Wenn Sie die AmigaBASIC-Variante gestartet haben, wählen Sie
  171.    'aktualisieren'/ `Update' aus dem `Fenster'/`Window'-Menü.
  172.  
  173. 2. Starten Sie nun `   CREATE_Lists' durch einen Doppelklick. Es erscheint das
  174.    Fenster `Befehl ausführen'/`Execute A File' mit dem Eintrag
  175.    "   CREATE_Lists". Bewegen Sie nun den Cursor ganz nach links und geben Sie
  176.    ein 'EXECUTE '. Klicken Sie nun auf `OK' und `   CREATE_Lists' wird
  177.    ausgeführt.
  178.  
  179. 3. Verfahren Sie mit der Datei `   CREATE_ListsII' ebenso, wie bei
  180.    2. beschrieben.
  181.  
  182.  
  183. II. `   Swap_ListsII'
  184.     -----------------
  185.  
  186.    Starten Sie nun `   Swap_ListsII'. `   Swap_ListsII' arbeitet vollautoma-
  187.    tisch und vertauscht nun die Einträge in den von `   CREATE_ListsII'
  188.    erzeugten Dateien (`ram:#?2.txt'). `   Swap_ListsII' erzeugt dabei neue
  189.    Dateien (`ram:#?.icon.txt').
  190.  
  191.  
  192.  
  193. III. `  Sort_ListsII'
  194.      ----------------
  195.  
  196.    Starten Sie nun `  Sort_ListsII'. `Sort_ListsII' ist wieder eine Batch-
  197.    Datei und arbeitet somit vollautomatisch. Die von `   Swap_ListsII'
  198.    erzeugten Dateien werden nun vom Befehl 'sort' alphabetisch sortiert.
  199.    'Sort' erkennt die Sonderzeichen Ä,ä,Ö,ö,Ü,ü und ß als eigenständige
  200.    Zeichen, also nicht als Ae, ae, Oe, oe, Ue, ue und ss. Daher sollten Sie
  201.    auf Sonderzeichen in Dateinamen möglichst verzichten.
  202.  
  203.  
  204.  
  205. IV. ` CREATE_HTM's'
  206.     ---------------
  207.  
  208. 1. Starten Sie das Programm ` CREATE_HTM's'.
  209.  
  210. 2. Geben Sie den Pfad an, unter dem die HTML-Dateien gespeichert werden
  211.    sollen. Es empfiehlt sich, den gleichen Pfad anzugeben, wie unter I.2.
  212.  
  213. 3. ` CREATE_HTM's' fragt, ob Sie ein Hintergrundbild einbinden möchten.
  214.    Bitte beachten Sie, daß das Hintergrundbild für alle Seiten gleich ist.
  215.    Wenn Sie 'J' eingeben, werden Sie nach dem Bildnamen gefragt. Das Bild
  216.    muß sich innerhalb des unter Punkt 2 angegeben Pfades befinden.
  217.    (Untervzeichnisse sind zulässig) Nach der Eingabe geht es weiter mit
  218.    Punkt 4.
  219.    Wenn Sie 'N' eingegeben haben, geht es weiter mit Punkt 4.
  220.  
  221. 4. ` CREATE_HTM's' erzeugt nun die HTML-Dateien für die Grafiken, sowie eine
  222.    Datei `INDEX.HTM', die Verweise auf die anderen HTML-Dateien enthält.
  223.  
  224.  
  225. V. 'DOS'
  226.    ----- 
  227.    Das Programm 'DOS' benötigen Sie nur, wenn Sie überprüfen wollen, ob die
  228.    Dateinamen MS-DOS-kompatibel sind.Gehen Sie wie folgt vor:
  229.  
  230. 1. Öffnen Sie eine Shell.
  231.  
  232. 2. Wechseln Sie in das gewünschte [Wurzelverzeichnis], z.B. 'Grafikdisk:Test'
  233.    mit
  234.    cd Grafikdisk:Test <RETURN>
  235.  
  236. 3. Geben Sie ein:
  237.    list #?/#? >ram:Liste.txt <RETURN>
  238.  
  239.    Dies listet die Grafiken in den Verzeichnissen auf und schreibt die Aus-
  240.    gabe in die Datei `Liste.txt' auf der "Ram Disk".
  241.  
  242. 4. Geben Sie ein:
  243.    list #?/#?/#? >>ram:Liste.txt <RETURN>
  244.  
  245.    Dies listet die Grafiken in den Unterverzeichnissen auf und schreibt die
  246.    Ausgabe in die Datei `Liste.txt' auf der "Ram Disk".
  247.  
  248. 5. Starten Sie `DOS' und geben Sie ein:
  249.    ram:Liste.txt <RETURN>
  250.  
  251. 6. 'DOS' überprüft nun die Dateien, die in der Datei 'Liste.txt' auf der
  252.    "Ram Disk" aufgelistet wurden. Das Resultat wird in der Datei 'Errors.txt'
  253.    auf der "Ram Disk" abgespeichert.
  254.  
  255.  
  256. VI. `Dateigröße'
  257.     ------------
  258.  
  259.   Dieses Programm wird nicht unbedingt zur Erstellung benötigt. Es zeigt
  260.   lediglich an, wieviele Dateien sich in den angegebenen Verzeichnissen befinden
  261.   und wieviel Platz dafür benötigt wird.
  262.  
  263. 1. Öffnen Sie eine Shell.
  264.  
  265. 2. Wechseln Sie in das gewünschte [Wurzelverzeichnis], z.B. 'Grafikdisk:Test'
  266.    mit
  267.    cd Grafikdisk:Test <RETURN>
  268.  
  269. 3. Geben Sie ein:
  270.    list #?/#? >ram:Liste.txt <RETURN>
  271.  
  272.    Dies listet die Grafiken in den Verzeichnissen auf und schreibt die Aus-
  273.    gabe in die Datei `Liste.txt' auf der "Ram Disk".
  274.  
  275. 4. Geben Sie ein:
  276.    list #?/#?/#? >>ram:Liste.txt <RETURN>
  277.  
  278.    Dies listet die Grafiken in den Unterverzeichnissen auf und schreibt die
  279.    Ausgabe in die Datei `Liste.txt' auf der "Ram Disk".
  280.  
  281. Die Vorgehensweise hat einen Nachteil: Wenn schon Thumbnails (im Verzeich-
  282. nis `ICONS' existieren, werden diese mitaufgelistet. Somit ergeben sich mehr
  283. Dateien, als Bilder vorhanden sind. Wenn Sie dies nicht wünschen, müssen Sie
  284. die Verzeichnisse einzeln angeben
  285. (z.B. list Grafiken1/#? >ram:Liste.txt <RETURN>)
  286.  
  287. 5. Starten Sie 'Dateigröße' und geben Sie ein:
  288.    ram:Liste.txt <RETURN>
  289.  
  290. Das Programm liest nun die Datei Liste.txt ein und gibt Ihnen nach kurzer
  291. Zeit die Anzahl der Dateien und den verbrauchten Speicherplatz an.
  292.  
  293.  
  294. VII. `Create_Index'
  295.      --------------
  296. `Create_Index' erstellt eine Indexseite, wie man sie von vielen FTP-Servern her kennt, also eine Auflistung mit den
  297. Dateinamen/Verzeichnissen als Links und der Angabe der Dateigröße und Dateiattribute. Das Programm benötigt dafür eine
  298. Textdatei, das die benötigten Dateien enthält. Diese Textdatei muß mit dem List-Befehl folgendermaßen erzeugt worden
  299. sein: List >Dateiliste
  300. Es ist auch möglich, nur bestimmte Dateien aufzulisten: List #?.txt >Dateiliste
  301. oder Dateien auszuschließen: List ~(#?(.html|.info)) >Dateiliste
  302. Wenn man an eine Dateiliste an eine andere anhängen will, geht man folgendermaßen vor: List >>Dateiliste
  303. Nachdem man die Dateiliste erstellt hat, startet man `Create_Index'.
  304. Das Programm fragt jetzt nach dem Dateinamen der Dateiliste und dem Speicherpfad. Dort wird dann die Datei 'index.html'
  305. erzeugt. Dieser Name sollte nicht geändert werden, da die gängigen WWW-Browser diesen Namen für Verzeichnisse erwarten.
  306.  
  307.  
  308.   History
  309.   =======
  310.  
  311.  V1.24 `Create_Index' erstellt.
  312.        Neue Adresse des Autors
  313.  
  314.  V1.23 ` Create_HTM's' bindet jetzt auch Hintergrundbilder ein.
  315.        ` Create_HTM's' verwendet jetzt den <TR>-Tag korrekt.
  316.        (Kleiner Schönheitsfehler. Hat bisher aber zu keinen
  317.        Darstellungsfehlern geführt.)
  318.  
  319.  V1.22a E-Mail-Adresse geändert (s. 'Der Autor')
  320.     Keine weiteren Änderungen
  321.  
  322.  V1.22 Bugfix von V1.21 ` Create_HTM's hatte mit Unterverzeichnissen Probleme.
  323.        Fehler 62 sollte nicht mehr auftauchen.
  324.  
  325.  V1.21 Bugfix von V1.2 `DOS' addierte die gefundenen Fehler nicht korrekt.
  326.        `DOS' zeigt jetzt nicht mehr jede 5. Zeile an, sondern zeigt die
  327.        gegenwärtig gelesene Zeile an.
  328.        'Fehler 53' wurde durch 'Datei nicht gefunden.' ersetzt.
  329.  
  330.  V1.2  Bugfix von V1.1 `Dateigröße' benutzte seine Fehlerbehandlung nicht.
  331.        Programm 'DOS' erstellt.
  332.  
  333.  V1.1  Bugfix von V1.01. `Dateigröße' erfaßte nicht alle Dateien im Verzeich-
  334.        nis.
  335.        Englische Ausgaben hinzugefügt.
  336.        Merkmale DEUTSCH und ENGLISH hinzugefügt.
  337.        Englische Dokumentation erstellt.
  338.  
  339.  
  340.  V1.01 Bugfix von V1.0. `INDEX.HTM' wurde nicht ordnungsgemäß abgeschlossen,
  341.        was den Netscape-Navigator 3.0 dazu veranlaßte, die Seite nicht anzu-
  342.        zeigen.
  343.  
  344.  
  345.  V1.0  Erste Version (programmiert in AmigaBASIC,
  346.        compiliert mit Cursor © Jürgen Forster)
  347.  
  348.  
  349.  
  350.  
  351.   Future
  352.   ======
  353.  
  354.  Vielleicht gibt's mal eine C-Version, die alles intern macht.
  355.  
  356.  
  357.  
  358.   Rechtliches
  359.   ===========
  360.  
  361.  Das Programmpaket `HTML-Creator' ist weder PD, noch Freeware oder Shareware.
  362.  
  363.  Der Autor ist nicht für Schäden verantwortlich, die direkt oder indirekt mit
  364.  der Benutzung von `HTML-Creator' in Zusammenhang zu bringen sind.
  365.  
  366.  Der Einsatz zur Erstellung von gewerblichen Datenträgern bzw. solchen, die
  367.  nicht dem Eigenbedarf dienen, bedarf der schriftlichen Genehmigung des
  368.  Autors.
  369.  
  370.  `HTML-Creator' darf ohne schriftliche Genehmigung des Autors nur auf
  371.  `AMINET'-CD-ROM's erscheinen.
  372.  
  373.  Für den Eigenbedarf dürfen Änderungen am Sourcecode vorgenommen werden.
  374.  Die geänderten Versionen dürfen nicht weitergegeben werden.
  375.  
  376.  MS-DOS ist Copyright, Microsoft Corp.
  377.  AmigaBASIC ist Copyright, Microsoft Corp.
  378.  
  379.   Der Autor
  380.   =========
  381.  
  382.   Martin Henke
  383.   Oelinghovener Str. 2
  384.   D-53639 Königswinter
  385.  
  386.   E-Mail: m.henke@01019freenet.de
  387.